Chapter 6 


Monitor Utility 


‘The monitor uit displays helpful information concerning the configu 
ration and operation of the Cobra, 


Connecting to a Monitor 


Use the supplied serial cable to attach a monitor tothe Cobra 
port at J6 The following ilustration points out the Location 
‘of the serial port on the CDI-1240, 
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Set your terminal's communications parameters to 9600 baud, S-bit 
data, stop bit, no parity, jump sere. 
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Accessing the Monitor Utility 


If you have the monitor connected at power up, you will see a series of 
boot up messages appear om the screen as the Cabra initializes its oper= 
ating code. At the conclusion of this procedure, the manitor utility wil 
display a message box containing the serial number, SCS nodename, 
SCS system ID and frmwaze version number of your Cobra, 
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‘The main menu will appear as soon as you press a key. 
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‘The opening menu presents you with three options: Monitor Infor- 
mation, System Parameters and DUP Programs. Use the cursor keys to 
‘highlight an option and press ENTER to elec it. You may press Cul-Z. 
at any time to exita sereen and move up to the previous level in the 
‘meni tree. You may exit the monitor ulility altogether by pressing Ctr- 
Zat the main mens 


‘The DUP Programs menu option is explained in chapters 7,8 and 
9. System Parameters takes you immediatly to the System Paratneters 
sczcen, which presents a read-only display of the Cobras configuration 
parameters, Fora full explanation ofthis scrcen, see page 6:7. If you se- 
lect Monitor Information, the tility will display a secondary ments 
with five choices as Mlusrated in the following s<teen recreation, 


cota Mentor Uity 


‘clo TECHNOLOGY, IN. 
ol300 
WEN 


Path Blocks tfomaton 


Conretn tnfenation 
st sais 


System Statistics 


‘System Statistics provides an inventory ofall the target devices and 
bosts connected to the Cobra, For DESI buses, the sereen displays 
‘which nodenames are located on which node IDs. For SCSI buses, the 
sezeen shows the ID of the Cobra on each bus, as well as the status of 
all target devices. In addition, the screen provides a continuously up= 
dated snapshot of system performance, 
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‘The preceding screen simulation shows a typical System Statistics 
display fora cluster with one host (nodename Biue) connected to port 1 
of the CDI-4240 by DSSI; and four devices connected to each SCSI bus 
‘on ports 0 through 3. Cobra is the nodename of the CDI-240. 


Exch port section is in the form of an array. When the Cobra de- 
tects a device on a bus, it displays a code representing the status of the 
device (see the following table for code definitions), The position ofthe 
code indicates the SCSI ID and LUN of the device. The vertical axis of 
the array represents the SCSIID, and the horizontal axis represents the 
LUN. In the simulated sereen show above, exch SCSI port has an “on- 
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line” device on 1D 0, LUN 0, an “available” device on ID 1, LUN 0, an 
“offline” device on 1D2, LUN O, and a “cached” device on ID3, LUN 0, 


Tabla 6-1 Device Table Port Codes 


Godo_| Meaning | Explanation 

| Onlina “The devicn s working propery and has Been 
‘aunt or init aze, 

‘A [Avaliskie | Tha device is working propery But has rat yet 
been mounted er insaizea 

[Cached | Oata rom tho device is cached, vang the Gobra's 
cmboard cache 

F | Ofte Tho cova has been deected on ha bus bal for 


somo reason (eg rt spun vp) fa rot avalabla 

for mounting or ialzing 

NM] Maintenance | The daviea has been selected for malntenanco 
through he Diagnostes Usity Procol (OUP) and 

4 nat avaiabl fr VO operatons win the host, 

‘node | Witator | Tha nodo name of ta Cobra wil appear next to 

ame As SCSII0. 


In the simulated System Statistics screen shown above, port 1 is 
dedicated to DSSI. The display for port 1, therefore, shows which sys 

i tems or devices (identified by nodename) are assigned to the eight pose 
sible DSSI nodes. 


‘The top, left corner of the sereen contains information about the per 
formance of the Cobra. The “cache hit" value indicates the percentage 
‘of read requests that have been satisfied from the Cobra’s cache rather 
than from slower device accestes. The “Roa/Sec" (requests per second) 
vvalue gauges the rate at which the Cobra is handling 1/0 request, 
"Cache Size” indicates how many megabytes of cache memory are in 
stalled on the board, 

‘The “Free Lists” section shows how the Cobra's buffers are allo- 
‘ated and used. This information i intended for use by CMD technical 
support personnel asa troubleshooting tool. You may be asked to pro- 
‘vide this information when you call CMD for technical support. 


DSS! Statistics 


‘This screen is intended as a too! for troubleshooting DSI problems— 
particularly eabling and termination issues. Although the information, 
fn this screen is technical and designed primarily for service personel, 
You may be able to use the sereen to identify potential problems with 
Your DSS interface, 
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1 you notice abnormal values on the DSSI Statistics sxeen, try the 
following steps before calling technical support 


©. Check the DSSI cable for defects, such asa bad wire ofa bad sole 
ddee connection. If possible try swapping the cable with another 
cable that you believe tobe in good condition, 


1D. Check termination on the DSSI bus. The bus should be termi= 
nated at both ends. Ifthe Cobra is at one end of the bus, make 
sure the D5SI tenminator resistor packs are installed propertly 
and the appropriate jumpers ate set. 


‘The CDI4240 supports up to two DSSI ports, vo there can be as 
many as two sels of DSI statistics, one for each port configured for 
DSS Sine the CDI 220 supports only ane DSI port the DSS Stat 
tics sereen will display a single st of statistics. Ech set of DSI staise 
tics contains two pages. The fist page shows statistics for nodes 0 
through 3 and the second page shows statistics for nodes 4 through 7, 
Use the N and P keys on the monitor keyboard to navigate among the 
screens. Press CtrleZ to ext the DSSI Statistics screen and C to reset all 
‘counters to zr0, 


‘The following fields are displayed on the DSSI Statistics screen 


No CDRP Count: CDRP, which stands for Class Driver Request 
Packet, isa buffer the Cobra uses to store packet header information. 
‘The number displayed in this field isa tally ofthe instances when the 
SSI driver needed a CDRP but no CDRP was available, This number 
‘will equal the total ofthe "RX no CDRP” felds forall nodes. 


No Buffers Count: The buffers referenced in this field are used by 
the Cobra to store the data portion of a packet. This value will inere- 
‘ment exch time the DSSI driver attempted to perform a write but could 
‘not perform the operation due toa lack of buffer space. 

Bus Resets Detected: This field increments each time the Cobra de- 
tects a DSSI bus reset. Occasional resets ate normal on DSI. However, 
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if you see this counter incrementing ata rapid rate (eg. once a second 
‘oF more) you probably have a cabling problem. 

‘Bus Resets Initiated: This feld displays the number of times the 
Cobra initiated a bus reset on the DSS The Cobra will initiate a bus re- 
set when it detects a parity eror. A high number of bus resets initiated 
could indicate a cable o interface 

Interface Fault Count: This field counts the number of times a fault 
‘occurs in the DSSI interface chip. Such faults usually occur asa result of 
a physical cable breakin a DSSI connection. 

‘TX ok The number of packets transmitted successfully. 


TX incomplete: The number of packet transmissions that were at= 
tempted but failed because the host went bus free before the entire 
packet could be sent. A high number of TX incompletes could indicate 
‘cabling problem. 


‘TX retry: A count ofthe numberof transmissions retried after an ine 
ital failure, 


Nak count: The number of negative acknowledgments (Naks) re- 
ceived ftom the host. host will issue a Nak when it has no buifer 
space to receive a packet from a node, 


RX oe The number of packets received successfully from a host. 
RX fail: The numberof filed transmissions that hosts attempted to 


send to the Cobra. failed transmission is usually eaused by a bad ea 
dle. 


RX bad source id: The number of packets rejected by the Cobra 
due to a problem withthe source ID in the header, 


RX bad dest id: The number of packets rejected by the Cobra due 
toa problem withthe destination ID in the header, 

RX bad header: The number of packets rejected by the Cobra due 
toa packet header problem other than a bad source of destination ID. 


RX no CDRP: The number of packets reected by the Cobra due to 
8 lack of CDRP butter space forthe packet header. The “RX no CDRP” 
field reports the same type of problem as the “No CDRP Count” field 
atthe top of the screen, except it reports the total fora single node 
rather than an aggregate forall nodes, 

RX no SGTD: The numberof packets rejected by the Cobra due to 
a lack of SGTD (Scatter-Gather Table Descriptor) bulfer space for the 
packet data. The "RX no SGTD" field reports the same type of problem 
4s the “No Buffers Count” feld atthe top of the seen, except it re- 
ports the total fr a single node rather than an aggregate forall nodes 


System Processes 
This scroen i intended as. troubleshooting tool for CMD Technical 


Support personnel. You may be asked to convey information from this 
screen if you call for assistance, 
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Path Blocks Information 


‘This screen is intended a5 a troubleshooting tool for CMD Technical 
Support personnel. You may be asked to convey information from this 
screen if you call for assistance. 


Connection Information 


‘This screen is intended as. troubleshooting tool for CMD Technical 
Support personnel. You may be asked to convey information from this 
sereen if you call or asistance, 


‘System Parameters, 


‘This menu option takes you toa succession of read-only screens 
that display the current parameters for the every port and device. You 
may change these parameters with the DUP PARAMS prograzn ( 
chapters 7 and 8) or with the font panel uility see chapter 5), 
‘The first screen that appears shows the current values for all sys 


tem parameters, All identifying information, such as “Nodename,* 
“System ID,” SCSI ard DSSI nose IDs apply tothe Cobra, 


ceovenensy ___gvstewonnauerens ___enceeian enna 


commen otNDhemncveay 


rete sess [roan 
Fexrowt Gu | ene Gaon ‘seers 
Eeaviee ense| Sante Pei 
Eaneee (0 | banner Uineacresunee 


Santee EehSe 


Wromscan | SoKGuRwe | purounaso | cme 


er 


Mentor Usity 


Cobra 


Disk Dovico Parameters 


The additional screens inthe Systems Parameters menu option give a 
portby-port listing of the local parameters for each ID and LUN. There 
are two screens for each port—ane screen for disk devices and one 
‘screen for tape devices. You may cycle through all the screens by presse 
ing “N" or jump to either the disk or tape screens by pressing the "D” 
‘or “T” key. A typical disk screen might look like the following example 
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‘This screen shows the disk parameters for every possible ID and 
LUN on Port 0. The four boxes on the top row represent LUN 0 
through 3, from left to right, The bottoms four boxes represent LUNS 4 
through 7, Eich row of values represents a SCSI ID, stiting with ID 0 
In the first row. The “Flags” column indicates how the disconnect (D), 
spndwn (6), immed (S0, cache (C) and device type (U) and tag que 
ing (1) parameters are set. legend for the Flags column is at the bot 
tom of the screen. The “Sync” columna corresponds tothe sync_fate pe 
rameter which sets the maximam syne rate (in megabytes per secon) 
for each ID and LUN. The third column in each box shows the MSCP 
unit number assigned to that ID and LUN, (Please ee page 8-7 for an 
explanation of these parameters) 

{In the sample screen shown above, all the IDs and LUNs are set to 
their default disk parameter values. For instance, a disk device on SCSI 
1D5, LUN Of Port 0 will have a MSCP unit number of 50. The device 
hhas.a maximum syne rate of 10. The TYPE parameter is set to DU, and 
the DISC, SPIN, IMMD and CACH parameters are all enabled, 

‘To view the parameter values forthe next pott, press the “N key, 
You may reverse direction and view the previous screen at any tine by 
pressing the “P” key. If you wish to jump directly to the first pe de- 
‘ees sercen, press the “T” hey, 
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Tape Dovices Screen 


‘The System Parameters screen for tape devices is similar to the disk de 
‘vices screen, except that parameters unique to tapes are substituted for 
the SPIN, IMMD and CACH parameters for disk devices. A typical 
screen might ook as follows. 
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Like the disk devices screen, the parameter values for exch LUN. 
are displayed in boxes, from LUN 0 in the top, left box to LUN 7 in the 
‘bottom, right box. SCSI IDs are listed from atthe top of each box to 7 
at the bottom. The first column in exch LUN box lists the values forthe 
DISC (Dy, SHTM (B), FIMS (P and TYPE (U) parameters, The second. 
column shows the value of the SYNC parametor for each ID and LUN, 
‘The third column shows the MSCP unit number assigned to that ID. 
and LUN. A legend fo the “Aags" column appears at the bottom of the 
scree 
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Chapter 7 


DUP Programs 


Accessing DUP 
‘There are two ways to acess the Cobra’ dingnost uty protocol 
(DUP) programs 
1. From the console or OpenVMS prompt 
©. From a monitor connected tothe Cobr 


serial interface 


‘This chapter contains instructions on how to access DUP programs 
via these two methods. For information about the PARAMS and 
UTILIT programs, see chapters 8 and 9. 

In addition, you may modify the Cobta's operational parameters 
{from the front panel, Se chapter 5 for more information about this fea: 
ture 


From the VAX Console 


Follow these steps to access DUP from the console prompt on 
‘OpenVMS VAX systems, 
1. Enter the SHOW DEVICE command at the console prompt. 
>> SHOW DEVICE 
DSSI_Node a (nodenane) 
=DuAg00 (RF72) 
=puAai0 (AF72) 
=DUARSO (R72) 
DSSt NODE 105 c+) 
UOSSP OFsk Controller 0 (772150) 
=DUAd (RAB2) 
Ethernet Adapter 
“ESAO (08-00-28-13-80-85) 
In the above example, the Cobra adaptor is on DSS! node 1D 0. If 
you have assigned a nodename to the adapter, it will show up in paren- 


theses in place of nadensm, otherwise nodensme will bea six digit num> 
ber. 
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2 Now that you know the Cobra's DSSI node ID, you can establish a 
‘connection to the adapter’s DUP server by entering one of two com 
mands, The configuration of your system will determine which 
‘command is appropriate. Use the following command if your sy3+ 
tem has just one DSSI bus, 

>>> SET HOST/OUR/OSSI a 

Starting OUP server 


Copyright (€) 1998 cHD Technoteay, Ine. 

Cols¥200 "Serial Ho: 0 

Firoeara Reve 8 
ouster v1.0 0 0817-99 1 
Pawan VI"0 0 8-19-93 10:80:01 
UiLUIT W150 9 oacty-93 T0:e0:02 
fnd of Directory 
Task none 

Replace th variable inthe command tine wth the DSSL node 1D 
ofthe Cobra. At the “Task Name prompt enter either “PARAMS” or 
“UTILI,” depending on whch program you want to enter 

Ses claper 8 fra dsciptnaf te PARAMS progam and cap 
ter9 fora desrption ofthe UTIL program. 

your stem has two DES buses, you mast include the bus on 
which th Car resides In your comming statement 
29> SET NOSt/OUP/OSSI/US: 1 a 
Starting UP server 
Copyeiahe (€) 1994 CHO Tecmnoteny, Ic. 

CO1"4200.” Sertat Hos 0 

Frmeare Reve 40 
DIRECT V1.0 0 08-17-93 1 
Pasusis V120 0 08-17-93 
UMILIT Vio 0 8419-93 102 
End of Otrectery 
Tesk ose? 


Replace the variable in the command statement with the bus num 
‘ber (0 or 1) and the variable a with the DSSI node ID of the Cobra. At 
the “Task Name?” prompt, enter either "PARAMS" of “UTILIT," de 
[pending on which program you want to enter, If you do not receive a 
“Task Name?” prompt, you have not established a link with the Co- 
bbra's DUP server. Check to make sure that you entered the proper com- 
‘mand in step 2 and that you ate entering the correct DSSI node ID for 
the Cobra, 


See chapter 8 for a description of the PARAMS program and chap 
ter9 for a description of the UTILIT program. 
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From the AXP Console 


Follow these steps to access DUP from the console prompt on 
(Open¥MS AXP systems, 


1 Enter the command SHOW CONFIG from the console prompt. 
>>> SWOM CONFIGURATION 


Censcle ¥2.8-9900 
P "8200-84 DECcHIp (TH) 210543 


Mesory 2 
Werory 3. P 2002-0 120 ¥9 


Ethernet 0? 08-60-28-32-E5-a8 
Ethernet 1? 08-00-28-32-66-A8 


19 101 12 103 104 105 106 107 
hava 


A set P Host 
8 BRAID Hest 
c ° aura Rene Host 
0 ° RFS Nost 
£ P7285 RRDA2 Host 
Futurebuse P F800 Host 
Systen Status Pass Type b to beot ducl.1.0.2.0 


‘The result isa map ofall devices on the system and thelr 

1D651/SCSI bus addresses. In the above example the Cobra shows up as 

E72 on bus C, DSSI node 1D 4. You will use this information in the 

next step. 

2 Connect to the Cobra’s DUP server by entering the following com 
mand 

>o> SEF Hosr -0uP @ 


Replace the variable d with the port addtess of the Cobra. For the 
system configuration mapped in step I, the cortect command would be 
as follows. 
>> SET HOST -OUP PUCO.4,0,2.0 
Starting OUP server 
Copyright (C) 1994 CHD Technology, Inc. 

01-4200 Serial Nor 0 

Firware Rev, 40 
DIRECT V1.0 0 08-17-93 11:80:00 
PARAMS V1.0 0 08-17-93 10:50: 
UTTLIT Vi.0 0 08-17-83 10:50:02 
End of Directery 


Task Name? 


‘The port address should conform tothe following format 
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puleo.|a.o.|2.Jo 

[Bus Number: Always 0 for tre Cabra 
Sict Number: Cvrosponds tothe storage adapter ei, wi 
[A mavng slot umber 0,8 navng slot number t and 30 0m, 


\Ghanrel Number: Used fot mut-channel devices 
[Does net apply to tha Cabra, 


lous Noga Number: The OSS! node 10 or SCSID ofthe cavice, 
Device Unt Number Tha unique MSCP unt numberof te device. 
[storage Adapter ID; The enoderer storage adapter designator 
(A,B,C, De) 
loner 1D: na twoeter port or cass driver designator (PU for a DSI por). 


3. Atthe “Task Name?” prompt, enter either “PARAMS” of “UTILIT;” 
depending on which program you want to enter, Ifyou do not ce= 
ceive “Task Name?” prompt, you have not established a link with 
the Cobra’s DUP server, Check to make sure that you entered the 
Proper command in step 2. 

See chapter 8 for a description of the PARAMS program and chap= 
ter9 for a description of the UTILIT program, 


OpenVMS Prompt 


Follow these steps to connect to DUP from the OpenVMS Prompt, 


1. Ifyoware working on a terminal connected to a VAX system, issue 
the folowing command to connect to the DUP server: 
5 MC SYSGEN CONNECT DUP_server/NOADAPTER 
Replace the variable DUP_sereer wit the name of the DUP server 
‘on your system. This is typiaily "FYAO." 
2 Ifyou are working on a terminal connected to an AXP system, issue 
the following command to connect to the DUP server: 
§HC SYSHN 10 CONNECT OUP_server/WoADAPTER/ORIVERASYSAFYOAIVER 
Replace the variable DUP_sercer withthe name of the DUP server 
‘on yout system. This is typically "FYAQ” 
3. Once you have connected fo the system DUP server, you ean access 
the Cobra’s DUP programs by issuing the following command: 
§ SET HOST/OUP/TASK=taséneme/SERVER“NSCPSOUP 
Replace the variable tasbname with either “PARAMS” of “UTILIT,” 
depending on which program you want to enter, You may also omit 
the TASK=teshname parameter, in which case you will be prompted to 
center a task name. Replace the variable # a the end of the comunand 
line with the nodename of the Cobra, 


See chapter 8 for a description of the PARAMS program and chap- 
ter 9 for a description of the UTILIT program, 
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Serial Interface 


‘This section assumes that you have already established a connection 
‘with the Cobra’s serial interface, If you have not, see chapter 6 for in- 
structions 


Follow these steps to connect to DUP fom the serial interface 
1. Select "DUP Programs" from the main ment 


2 _Atthe “Task Name?” prompt, enter the DUP program you want to en- 
ter—either PARAMS or UTILIT. 


See chapter 8 for a description of the PARAMS program and chap- 
ter9 fora description ofthe UTTLIT program, 
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PARAMS 


Overview 


‘The DUP program PARAMS provides a means to modify the Cobra’s 
‘operational parameters, These parameters are divided into three 
_groups: system parameters, port parameters and device parameters, 
‘System parameters include the DSSI node rame and system ID of the 
Cobra, as well as the allocation class forthe disk and tape devices con 
trolled by the Cobra. Port parameters control how the Cobra scans its 
'SCSI buses to look for devices, And device parameters set such device- 
Taye atributes as the unit number of exch device, whether a device is 
online of offine to the host and whether data from a device {s to be 
cached by the Cobra, The remainder of this chapter provides a coms 
plete list of system, port and device parameters and instructions on 
hhow to modify them, 


PARAMS Commands 

‘The following commands are available in PARAMS. 

HELP 

Enter this command to view a brief summary of PARAMS commands 


and their proper syntax, 


SET SYSTEM 


Use this command to set the following system parameters: SYS- 
TEMLID, NODENAME, DISK_ALCS, TAPE_ALCS, MAX_HOSTS and 
MAX_CACHED_UNITS. See “System Parameters” stating on page 8:4 
for definitions and descriptions ofthese parameters. The syntax of the 
SET SYSTEM command is as follows: 
SET SYSTER paraneter=cvstue> [1 

«.cwhete parameter isthe keyword of the parameter you wish to 
change, and <value> is the new value for the parameter, [.] indicates 
that more than one comumind may be entered oma single line, 


PARAMS 


82 


‘The following are examples of the SET SYSTEM command, 
SET SYSTER NODENAME=cosex 

SET S¥STEH MaKHosTS=14 

SET SYSTEM OISK_ALES@4 TAPE ALCSH4 


SET PORT 


Use this command to set the following port parameters: SCANNING, 
SCAN_RATE and POWER_ON_RESET. See “Port Parauieters” starting 
‘on page 8-5 for definitions and deseriptions of these parameters, The 
syntax of the SET PORT command is a3 follows 
SET PORT <p> parancter=<value> fou} 
sswhere <p> isthe port number, parameter (s the keyword of the 
parameter you wish to change, and <value> isthe new value for the pa- 
ameter, You may use an asterisk (*) in place of <p> if you wish to 
change the sime parameter fr all ports. ..] indicates that more thon 
‘one command may be entered on a singte line, 
‘The following are examples of the SET PORT command, 
SET PORT 1 SCANNING-DENSE 
SET PORT 0 POWER_ON.RESET-DN SCANNINGsHONE 


SET PORT * SCAM RATE-80 


SET DEVICE 
Use this command to set the following device parameters: ONEB, 
CACH, TYPE, DISC, FIMS, IMMD, UNIT, SHTM, SPIN, SYNC, TAGQ, 
WPRT, TRNC, ADD and SUBTRACT. See "Device Parameters” starting 
‘on page 8-7 for definitions and descriptions of these parameters. The 
syntax of the SET DEVICE command isa follows: 
SET DEVICE <p> C1>paraneter=<vetue> (41 

ssawhete <p> isthe port number, <i> is the SCSIID of the device, 
parameter i the keyword of the parsmeter you wish to change, and 
svalue> is the new value forthe parameter [1 indicates that more 
{Hun one command may be entered ona single line. You may use an ase 
terisk (in place of <p> and/or <i> if you wish to change the same pa- 
rameter forall ports and/or all SCSI IDs, 

‘The following are examples of the SET DEVICE comand. 
SET DEVICE 1 2 oNea*OFF 
SET DEVICE 2 4 TAGO+ON Wrar-oFF 
SET DEVICE * * CACH*ON S¥ncod 
SET DEVICE 3 * aDd-1000 


Ovannwe 
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Theo DEVICE parametors 

lake etctInmadaly ater 
you uso the SET DEVICE 
command to chango them, 
‘Thesa paraneteys aro ONES 
(ecling enable), CACH feacho) 
‘and WPRT (wr pote!) As 
soon as you got thoso 
purer, thelr new valoos 
become par elt curent 
contguratn raced without 
‘th reod fr tho 
WRITERESTART procedure, 
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SHOW ALL 


Issue this command to view a listing ofall SYSTEM, PORT and DE- 
VICE parameters. 


SHOW DEVICE 


‘This command displays a Usting of all DEVICE parameters for every 
port and SCSHID, 


SHOW SYSTEM 
This command displays alsting ofall SYSTEM parameters, 


wrITe 


When you use the SET SYSTEM, SET PORT or SET DEVICE command 
to change a parameter valve, you are actually editing a duplicate of the 
ccurtent configuration record, which contains the parameters that con 
trol the Cobra. The changes you make to the duplicate do not become 
prt of the current configuration recoed until you WRITE the duplicate 
to the Cobra's nonvolatile random access memory (NOVRAM) and re- 
initialize the Cobra by issuing the RESTART command ot by recycling, 
power, 

‘The WRITE command takes no arguments. Be sure to follow up the 
WRITE command with RESTART to initialize your changes. 


FACTORY 


‘The FACTORY command restores all parameters in the duplicate con- 
figuration record to thelr factory default values, To make the factory de- 
faults the current operating parameters, you must perform the 
WRITE/RESTART procedite. 

‘The FACTORY commund takes no arguments. To iste the come 
mand, type FACTORY by itself on the command line. 


REFRESH 


‘The REFRESH command erases any parameter changes (except changes 
snude to ONEB, CACH and WPRT, which take effect immediately) and 
‘creates a new duplicate copy of the current configuration record, Use 
this command when you hive second thoughts about a series of 
changes and want to start over again froma clean slate. 

1f you can also use this command to take back a WRITE. If you 
‘wish to restore the Cobra’s NOVRAM to its state before the WRITE, is. 
sue the REFRESH command, followed by another WRITE command, 
This will restore the old NOVRAM values. This procedure wall not 
work if you RESTART the controller after the intial WRITE. 


PARAMS Cobra 


‘The REFRESH command takes no arguments. To issue the com> 
mand, type REFRESH by iteelf on the command line, 


RESTART 


Use the RESTART command to reinitilize the Cobra after you have 
changed parameters with the SET conunand and saved them fo the 
NOVRAM with the WRITE command, You do net need to perform a 
RESTART when you change the ONEB, CACH or WERT parameters, 
‘Changes to these parameters take effect immediately 


‘The RESTART command takes no arguments. To ise the com> 
‘mand, type RESTART by itself on the command line, 


our 


Exita DUP PARAMS session with the QUIT comunand. This will take 
‘you back to the DUP directory. Exit DUP altogether by pressing CteC 
fr the BREAK key. ff you are accessing DUP through the Cobra’s serial 
interface, press Cl1-2.to return to the main menu. 


System Parameters 


System parameters configure the Cobra fora particular operating envi« 
fonment. The six system parameters rocognized by the Cobra a listed 
‘below. Factory default settings are indicated with bold face type 


Valid Ent 

Parameter uP Front Panel 

SYSTEMIO to 26043088 1 to 268855886, 
(ato72) (31072) 

NODENAME 8 characters (181072) | <8 eharactra (191072) 

DISK_ALCS 010.285 @) 010255 (@) 

TAPE ALCS 010.255 (8) (019 255 (4) 

MAK HOSTS 11092 11992 

Max. cACHED UNITS [oto 255 (8) 010 285 (8) 
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Descriptions 


SYSTEMID: Specifies the lower-order 32 bits ofthe 48-bit system iden 
tiGcation number, Exch node in the system must have a unique system 
ID. The higher order 16 bits are reserves by Digital Equipment Corp. 

for future use. 


NODENAME: Sets the DSSI node name of the Cobra. The name must 
‘be unique among all nodes inthe system. You may enter a name that is 
up to eight characters fong, but VMS will recognize only the Est six 
characters, The node name may contain any alphanumeric character ex- 
cept the dollar sign (6) oF the underscore () character, 

DISKALCS: Determines the device allocation cass fr all disk devices 
connected tothe Cobra, If you wish to have the disks served to other 
nodes in the system, this parameter must be greater than zero and 
match the ALLOCLASS SYSGEN parameter on all connected systems, 
TAPE_ALCS: Determines the device allocation lass for all tape de- 
vices connected to the Cobra. If you wish to have the tape devices 
served to other nodes inthe system, this parameter must be greater 
than zeto and match the ALLOCLASS SYSGEN parameter on all con- 
nected systems, 

MAX_HOSTS: Specifies the maximum number of hosts with which the 
‘Cobra will communicate For best results, set ths to the number of 
hosts in your system, 


MAX. CACHED_UNITS: Specifies the maximum number of disk de- 
‘vices fo be cached on the CDI-1204 cache board. You should set this 
rameter tothe langest number of devices you expect to cache. This per- 
its the Cobra to configure itelf for maximum cache efficiency. 


PARAMS 
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Port Parameters 
Port parameters govern the Cobra's DSS and SCSI ports, The four sys- 
tem parameters recognized by the Cobra are listed Below. Factory dex 
fault settings are indicated with bold face type. 


Table 8-2 Port Parameters 


Valid Envios 
Parametar uP Front Panel 
SCSLIO 9107 (how ont) | NA 

DSsiIO 0107 (how ont) WA 

‘SCANNING Dense, Sparse, Nona _ | Dense, Sparse, Nono 
SCAN RATE 010255 seconds (60) _ | 0 10 255 socends (69) 
POWERON.RESET | On OM Yea No 


Descriptions 


SCSILID: This pramte shows the SCSI 1D ta putin Cobra 
ort. You may view the value of ths parameter om he ron pal or 
through DUP, but you may not max To change the SCH ID fora 
Pot, you must manipulite the appeopitemipers on the ta 


DSSI_ID; This parameter shows the DSSI node ID of a particular Co- 
bbra port. You may view the value ofthis parameter on the front panel 
of through DUP, but you may not modify it. To change the DSSI node 
1D for a port, you must manipulate the appropriate jumpers on the 
board. 


SCANNING: When set to “dense” of “epats,” this parameter will 
‘use the Cobra to periodically sean all SCSI buses for new devices, 

Use “dense” when your devices are packed on exch SCSI bus, with no 
vacant addresses between devices installed on the same bus. A "dense" 
scan will begin a SCSt ID 7, logical unit number (LUN) 0 and progress 
through each LUN until it finds a vacant address, at which point it be- 
{gins searching LUN O of the next smaller ID. "Dense” scanning will not 
find a device if there is a vacant LUN between it and the preceding de- 
vice on the same bus. Use “sparse” when your devices art scattered on, 
the bus, with vacant addresses among them. A “sparse” scan will 
search every 1D and LUN on exch bus. The scanning frequency is deters 
‘mined by the sear_rate parameter, When scanning is set fo “none,” the 
‘Cobra will perform a single scan on each SCSI bus when power is 
turned on, 


SCAN_RATE: When the scanning paramete is vt to “sparse” or 


“dense”, seon_rate determines how frequently (in seconds) scans take 
hice. 
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POWER_ON_RESET: This parameter enables or disables the issuance 
ofa SCSI bus RESET on power-up, 


Device Parameters 


Device parameters control how the Cobra treats each device connected 
tot. The 15 system parameters recognized by the Cobra are listed bo- 
low, Factory default settings are indicated with bold face ty 


= Table83 Device 


Vali nies 
Parameter uP Front Panel 
Typ U1 01 (614) MU pe) | DUI sk: MU tage) 
Uni to 0000 009909 
Ore onion ONLINE | OFFLINE 
Wor On 01 Yes No 
Syne Do tO MBioe syne to 10 Mice 
Gach ‘ni oH noi 
Die On ort Ye 
Ta nit Ye 
Sein ‘ontoit Ye 
tna ‘On| 0H Yes No 
Sha on om Yes to 
Fina Oni om Yes No 
Tone not Yes No 
aaa 110 0099 wa 
Subvact [1109009 BA 

Descriptions 


‘Type: This parameter determines the default device type for disk and 
tape devices controled by the Cobra. For disk devices, you have two 
choices: DU, the standard disk type for UDA disks, or DI, the disk type 
for DSSt disks. Neither device type caries any advantage over the 
other in terms of performance or serving ability, 
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Unit: This parameter permits you to spesfy a unit number for any pyr 
cular device. The unit number isa component of the physical device 
zrame that VMS uses to address storage devices, By default, the Cobra 
assigns unit numbers according tothe following formula: (100*port) + 
(1O"id), For devices on LUNS, add the LUN to the base unit number for 
the LUN's port and SCSI ID, For example, the default unit number for 

a device on port 1, 1D3, LUN 3 would be 153, Ifyou change the default 
unit number for any port-D address, be sure that it does not conilit 
with another unit number. 


Oneb; The Oneb (online enable) parameter makes a device online with 
fespect to the host when set to “en” and offline when set to “off” Set 
this parameter to “off” when you want to block the transmission of 
‘commands from the host to a particular device. For normal operation, 
set Oneb to “on.” 


Wprt: prt enables or disables write protection on a device, Set prt 
to “on” to enable write protection and prevent a host from writing 10. 
device. Set the parameter to “off” to disable write protection. 


Syne: This parameter sets the maximum rate (in megabytes per sec- 
fond) at which the Cobra will attempt to transfer data in synchronous 
‘mode. Ifthe Cobra cannot negotiate the maximum rte with the device, 
it will work its way down until it can agree ona lower rate, Syne must 
bbea whole number between zero and 10. A sync rate of zero forces the 
Cobra to communicate with the device in asynehtonous mode. 


ach: Use this parameter to st caching on or off for a device. When 
You set Cath “ot” for a device, the Cobra will not exche data frown thot 
{evice. Turn Cack “on” when You want to store dala from a device in 
the Cobra's read cache, 


ise: Set this parameter to “on* to enable disconnect for a device, Dis- 
connect i a featuce of SCSI that enables a target device to temporarily 
disconnect from the bus while it processes a command, When it com 
plete its work, the device reconnects to the bus to transmit a response 
to the intator. Disconnect can enhance performance by allowing other 
devices to access the bus while a device is performing lengthy opera- 
Hons, such asa tape rewinds or disk seeks. If you have only one device 
‘ona bus, you will get beter performance by dissing disconnect (set 
disc to “of”. 

TagQ: This parameter enables or disables tag queuing. Tag queuing 
[permits exch initiator to issue commands with instructions for how the 
target should handle the command. An initiator can specify whether 
fech command should be executed by the trgetat the frst opporti- 
nity, in the order in which it was received, or at a time deemed appro- 
priate bythe target. Tag queuing permits each iniator to have multi- 
ple commands outstanding and each target to optimize the commands 
it receives 

Spin: Use this parameter to enable or disable spin down, When set to 
“on,” the Cobra will spin down drives or eject media when the operat 
ing system issues a spin down command stich as the VMS DIS- 
MOUNT/UNLOAD command. 


Prensa nota that tha Cobra, 
‘doesnot perorm consistency 
‘ecking fo vont tata 
<evieosundor its conte Navo 
‘unique deca unit umber. 
\s tho users responsibity 0 
00 Dat no two deveos Nave 
tha sama unit number. Ths Is 
partculary bua a tha ata of 
tho Add and Subvact 
commands, which easly ean 
result in duplicate unit numbers 
ityou ao noteareh, 
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Immd:_When st to “on,” ths parameter sets the IMMEDIATE bitin 
the SCSISTOP and START commands. You should turn this parameter 
“oli” if you have a Sony optical disk drive connected to the Cobra, 
When set to “off” the VMS prompt will not retuen until the drive’s me- 
dia Is ejected or the drive has spun down, 

‘Shtm: When set to “on,” this parameter enables the writing of short 
filemarks on Exabyte devices. When disabled ("of") all lemarks will 
‘be written as long filemarks, 

-Fems: When set to “on, this parameter enables high speed forward 
and reverse flemark searching. This mode can increase tape drive per 
formance, but it should not be used when you intend to perform a 
‘VMS standalone backup. 


Trig, When this parameter is disabled (Yoft), disks controlled by the 
Cobra will be compatible with other CMD Technology adapters, Ifyou 
Are not using other CMD adapters, turn truncation “on.” This truncates 
the number of blocks to be divisible by 126 fo faster VMS volume shad 
owing eatchup time, 

‘Add; Uso this parameter in conjuction with the wildcard character () 
to quickly add a specifed value to the unit numbers of a group of de- 
vices. For instance, the folowing DUP command adds 1000 to the unit 
‘number of exch drive on port 2. 

SET DEVICE 2 * A0dm1000 


{fan addition would cause a unit number to exceed the maximum 
‘value of 999, the calculation automratieally resumes from 0. For exam- 
ple if you add 1000 to a device with a unit number of 9100, the result 
{ng unit number willbe 100, 


Subtract: This parameter is similar to Add, excopt it subtescts a spect- 
fied value from the unit numbers of a group of devices, The following 
‘command subtracts 1000 from the unit numbers of all devices on port 1 
SET OEVICE 1 + suarRAcT=1000 


Ia subtraction would cause unit number to be less than the mini- 
‘mum value of the ealeulation automatically resumes from 10000. For 
‘example if you subtract 100 from a device with a unit number of 50, 
the resulting unit nusmber will be 9950, 
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Chapter 9 


UTILIT 


Accessing Device Utilities 


‘The Cobra offers builtin utilities to format, qualify and test the devices 
they contro, You may access these utilities by selecting the UTILIT task 
from the DUP utility. 


UTILIT Commands 


‘This section describes the commands available under UTILIT, 


HELP Command 


‘You may enter the HELP command to receive a listing of all available 
UTILIT commands and their syntax. Ths is an example ofthe output 
from the HELP command, 


UTILIT> HELP 


HELP 
SHOW 
SELECT 
Desevecr 
ABORT 


= Disk Commands — 


Forwar device name 
GUALTEY Gevicecname (/¥R1TE) 
DISKTEST device.nane (/4RITED 
= Tape Cormands ~ 

TaPETEST eevice mane 

unluT> 


92 


‘The variable device name stands for any valid MSCP/TMSCP de- 
vice label, Examples of disk drive device labels would be DIA100 and 
DUAI20. Device labels for tape devices begin with MU, such as 
MUA20, 


‘SHOW Command 


‘The result ofthe SHOW command isa listing of information about the 
device. name or all devices ifthe / ALL. qualifer {s specie. 


UTIL sHo¥ 
Sevice $10 Yenser wetel sev dev Stat Maint Oper Matt status 
uageo 2-0 Ofc) ALR ANSE MAINT —IOLERLADY 
UTIL show /ALL 

Device S10 vender Model sey tev Stat Malet Oper Hint status 
BUARIO 4-0 BEC AI2B —AQGE MAINT —-OISKTEST IN PROGRESS 
BuARBD 2-0 EC RIB A3GC MAINT TOLE. READY 
MRI 490 OEE TH26 O4pL AVATLARLE 

MUAR6O 6:0 OCC TKI6 OMB MAINT. TAPCIEST IN pkaoatss 


‘Table 9-1 describes the contents of each column in the SHOW out- 
put display. H 


' Tablo 91 SHOW Command Output 
oh uuwuOH 


Column | Deserpton : 
Dovico | The MSCP er TMSCP deview name 

S10 Tho SCSIIO—LUN of tho dovieo 

Vendor | Tho venders nama, suncated to seven characters 

Model “The dovea model name, runcated ta seven charactors 

Rov ‘Tha manufacturer's revision coda fr the devcw rmwaro 

Dev Stat __| The current status ef tha device 

‘Maint Opar_| The UTIL eparaten, any, eurenty underway 

‘Maint Sts | The stain ef he curent UTILIT eperaton 


SELECT Command 


Before you can perform a UTILIT operation ona device you must first 
SELECT it. The act of selecting a device changes its operational status 
to MAINT and renders it unavailable to the OpenVMS operating sy5- 
tem. 

Only devices listed as AVAILABLE by the SHOW command can be 
selected. Device listed as OFFLINE oF ONLINE connat be selected. 
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‘The following example of the SELECT command begins with a 
SHOW command to illustrate the change that occurs to the “Dev 
Status" column. 


SELECT Example 
UTILIT> show ouze0 


Device SID veneer wecet Bev ee Stat Malnt Oper Maint status 
DyAgz0 2-0-0€CRIZH ANSE AVATIABLE 


uriuit> setcer ovs22e 
Device SID Venter Mego) fay ev Stat Matnt oper wate Status 
uaaz0-2-0t¢caa28 ANSE MAINT READY 


DESELECT Command 


‘The DESELECT command returns a selected device to AVAILABLE 
status and allows the operating system to again access it 


DESELECT Examplo 
UrterD svew ousze0 


Device $10 vendor Model fev pee Stat Maint oper Myint status 
wiaez0 2-000 Azza 13ST vant HEAOY 


urturt> oestueer ovnzz0 
Avice $10 vendor Model Qov dev Stat_vatnt Oper Watnt status 
GUARD 2-0 OFC AL2O —435E AVATLASLE 


ABORT Command 

‘The ABORT command terminates a QUALIFY, DISKTEST or 
‘TAPETEST operation. These operations normally run indefinitely oF un- 
til stopped with the ABORT comunand or by shutting off power to the 
adapter, 

ABORT Example 


UTELIT> ABORT ovAze0 
unui 


FORMAT Command 


Use the FORMAT command to format a disk drive that has boen 2e- 
lected with the SELECT command, Since the format operation will di 


unur 


Cetra 


stroy any data on the disk drive, you will be prompted to confirm that 
‘you ssh to proceed. If you respond with “N° or “NO,” the format wil 
‘be aborted with no affect on your data, Enter “Y” ot “YES” to proceed 
‘with the format, Once initiated, the format operation cannot be aborted 
with the ABORT command. 


FORMAT does not produce any message when the operation is. 
completed. You should periodically issue the SHOW camman: 
thheck on the status ofthe format. It isa good practice #9 nin one or 
more QUALIFY passes on the drive after a format 


FORMAT Examplo 
Unter» FomsAT ousaeD 


oun eo ote ANG MT maT Tne RT 


1 devices Are you sare (V/NID YES 


QUALIFY Command 


‘The QUALIFY command will verify the readability of the media in a 
disk drive, f you use the /WRITE qualifier, the command also detects 
and replaces bad blocks on the media, Use the QUALIFY command by 
itself when you want to verify the integrity of a disk drive that alzeady. 
contains dat, since the operation only reads feom the disk drive, Use 
the QUALIFY command with the /WRITE qualiier on newly format= 
ted drives for a more thorough test of the drive's integrity. 

‘The (WRITE qualifer causes QUALIFY to write 32-4ilobyte data 
chunks to the drive and then read them back. QUALIFY verifies the en- 
tire disk, block by block When it reaches the final Block it returns to 
the fist block and repeats the process. This continues indefinitely unt 
You stop the operation by issuing the ABORT command or by turning 
‘ff power to the adapter. 

You must SELECT a device before performing a QUALIFY opera- 
Hon on it 


QUALIFY Exampio 


Unturt> cutter cuszea 


oune ea ete ats aE NT tar 


fe ens cevees are you sure (1/802 YES 


UTUT Commands 


cobra unur 


DISKTEST Command 


‘The DISKTEST comunand exercises the selected drive and corrects any 
media errors. During a DISKTEST /WRITE operation, the Cobra writes 
to randomly selected logical blocks on the device and then reads and 
verifies the data, Ifthe device you want to test alzeady contains data, 
omit the / WRITE qualifier, and DISKTEST will simply read from ta" 
domly selected logical blocks For newly formatted devices, you must 
use the /WRITE qualifer, or else DISKTEST will have na data to read, 
‘You must SELECT a device before running DISKTEST on it 


If DISKTEST encounters an error that it cannot correc, it will ise 
play a message desenbing the error condition. 

DISKTEST will un indefinitely until you issue the ABORT com: 
mand of turn off power tothe adapter, 


DISKTEST Example 
niin etre essa 


TAPETEST Command 


‘TAPETEST exercises the wlocted tape device by writing, rewinding and 
reading each section of tape, up to but not including flemarks. The 
‘lock size for the intial write is 32 kilobytes, This is halved on each suce 
cessive write/rewind read operation. The test restarts when the block 
size reaches 1 kilobyte, TAPETEST will replace any media erzors it dis- 


‘You must SELECT a device before sunning TAPETEST on it, Be 
sure that the tape device contains enough tape for 10 megabytes of 1 kis 
lobyte blocks otherwise TAPETEST will ot work. 


‘TAPETEST will run indefinitely unt you stop the operation with 
the ABORT command or by turning off power to the adapter. 


Ie TAPETEST encounters an error that it cannot correct, it will dis: 
play a message describing the error condition. 
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Appendix A 


Other Components 


‘This appendix describes the front panel, power and serial interface con 
nectors on the CDI-4220 and CDI-1240, as well as other miscellaneous 
components. 


Fig, A CDI-1240 other compenents 


EPROM Size 


Jumpers W1 and W2 specify the size of the EPROM on the CDI-1220 
and the CDI-1240. These jumpers will be set properly when you receive 
your adapter, and you may never nees to totich them. The only 

Sion that may call for you to change these jumpers isa firmusate up- 
sgrade. Ifthe EPROM containing the new Brmvvace has a different capac 
ity than your old EPROM, you must change jumpers WI and W2 ac- 
cordingly. 
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Fig, 2: EPROM sizosolecter (1 & Wa) 
"= Tablo Act_Jumpors W1 and W2 (EPROM Size) 
EPROM Sieo | ws (tz) [wr ea) [ waa) | wa (2a) 
128K m iN 
2seKo m m7 
512K0 m mo 
022K m iN 


Front Panel Connectors 


‘The cables from the front panel display attach to connectors J4 and J5, 
‘with the eable to the front panel buttons going to 4. and the LCD dis- 
play eable going to JS 


Front Panel Connoctors 
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Power Supply 


The CDI«220 and CDI-4240 receive power (5 volts, 1.5 amps) through 
connector J) 


Serial Interface 


‘You may attach a monitor to the serial port at J6. The serial interface 
provides a means to view status screens and change adapter parame 
ters. 


LED Indicator 


‘The LED indicator (051) provides visual confirmation of adapter opera 
tions and information about errors encountered, 


Manual Reset 


Jumper W3 provides a means other than recycling power to manwally 
reset the adapter. To reset the adapter, short the two pins with a 
jumper shunt. The adapter will mumediately reset. 
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